home *** CD-ROM | disk | FTP | other *** search
/ Informática Multimedia 1995 April / Informatica Multimedia CD - Epimundo.iso / DOS / FILEFIND / FFF / FFF.DOC < prev    next >
Encoding:
Text File  |  1990-07-08  |  15.0 KB  |  290 lines
  1.                         FFF - Fast File Find
  2.  
  3. Version:   3.4.5                                                        |
  4. Date:      July 9, 1990                                                 |
  5. Author:    Don A. Williams                                            
  6.  
  7. FastFileFind is a program that is functionally similar to the familiar 
  8. WHERE.  It will search on or more disks, looking for files whose names 
  9. match a specified pattern.  The major difference between FFF and other 
  10. programs of its type is that  FFF  can,  optionally,  look  for  files
  11. inside  of any of five of the more popular archive file formats,  .ARC
  12. (or &PKA),  .LZH,  .PAK,  .ZIP,  and .ZOO.  Also,  FFF is fully in the
  13. public  domain  -  no  copyrighted  code  and  all  of the source (for 
  14. Borland's Turbo C) is included.  By default,  FFF  searches  only  the 
  15. current disk and will search inside of any of the common archive files 
  16. that  it  finds.  The disk or disks to be searched can be specified on 
  17. the command line and there is a command line option  to  suppress  the 
  18. searching inside of archive files.  
  19.  
  20.         *********************  NOTICE  ************************
  21.         *  Contrary to the current trend in MS-DOS  software  *
  22.         *  this  program,  for whatever it is worth,  is NOT  *
  23.         *  copyrighted (with the exception  of  the  runtime  *
  24.         *  library  from  the C compiler)!  The program,  in  *
  25.         *  whole or in part,  may  be  used  freely  in  any  *
  26.         *  fashion or environment desired.  If you find this  *
  27.         *  program  to  be  useful  to you,  do NOT send any  *
  28.         *  contribution to the author;  in the words of Rick  *
  29.         *  Conn,   'Enjoy!'   However,   if   you  make  any  *
  30.         *  improvements,  I would enjoy receiving a copy  of  *
  31.         *  the  modified source.  I can be reached,  usually  *
  32.         *  within 24  hours,  by  messages  on  any  of  the  *
  33.         *  following Phoenix, AZ systems (the Phoenix systems *
  34.         *  can all be reached through StarLink node #9532):   *
  35.         *                                                     *
  36.         *     The Tool Shop BBS       [PCBOARD] [PC-Pursuit]  *
  37.         *         (602) 279-2673   1200/2400/9600 bps         *
  38.         *     Technoids Anonymous     [PCBOARD]               *
  39.         *         (602) 899-4876   300/1200/2400 bps          *
  40.         *         (602) 899-5233                              *
  41.         *         (602) 786-9131                              *
  42.         *     Inn On The Park         [PCBOARD]               *
  43.         *         (602) 957-0631   1200/2400/9600 bps         *
  44.         *     Pascalaholics Anonymous [WBBS]                  *
  45.         *         (602) 484-9356   1200/2400 bps              *
  46.         *                                                     *
  47.         *  or:                                                *
  48.         *     Blue Ridge Express     [RBBS] Richmond, VA      *
  49.         *         (804) 790-1675   2400 bps [StarLink #413]   *
  50.         *                                                     *
  51.         *     The Lunacy BBS         [PCBOARD] Van Nuys, CA   *
  52.         *         (805) 251-7052   2400/9600 [StarLink 6295]  *
  53.         *         (805) 251-8637   2400/9600 [StarLink 6295]  *
  54.         *                                                     *
  55.         *  or:                                                *
  56.         *     GEnie, mail address: DON-WILL                   *
  57.         *     CompuServ:           75410,543                  *
  58.         *                                                     *
  59.         *  Every  effort  has  been  made to avoid error and  *
  60.         *  moderately extensive testing has  been  performed  *
  61.         *  on  this  program,  however,  the author does not  *
  62.         *  warrant it to be fit for any  purpose  or  to  be  *
  63.         *  free  from  error and disclaims any liability for  *
  64.         *  actual or any other damage arising from  the  use  *
  65.         *  of this program.                                   *
  66.         *******************************************************
  67.  
  68.  
  69. USAGE:
  70.  
  71.         C:>FFF [disk_specifier(s):]pattern [pattern ....] [options]     
  72.  
  73. The disk specifier(s) are  the  concatenation  of  the  drives  to  be 
  74. searched  and  the  pattern  are  standard  MS-DOS file name patterns, 
  75. optionally including "wild cards".  With version 3.2.0, FFF can search  
  76. for multiple patterns in a single pass.  By default,  FFF will  search  
  77. the "current disk" if no disks are specified on the Command line or in  
  78. the  FFF  Environment Variable.  FFF offers one small enhancement over  
  79. the MS-DOS pattern matching in that  it  will  allow  the  "match  any 
  80. number  of any characters" character,  "*",  to appear anywhere in the 
  81. pattern,  not just at the end.  If, at any time during the search, the
  82. user presses the "ESC" key, FFF will immediately terminate.           
  83.  
  84.  
  85. OPTIONS:                                                                 
  86.                                                                          
  87. FFF recognizes six options:                                            
  88.                                                                          
  89.         -a·Reverses  the  default  setting  for  searching  inside  of  
  90.            archive files.  The FFF default is ON - to search inside of  
  91.            archive files - but may be modified by the  user  with  the  
  92.            "FFF" Environment Variable.                                  
  93.                                                                          
  94.         -v·Reverses  the  default  setting  for  the  verbose printing  
  95.            option.  The FFF default is OFF  -  do  NOT  print  verbose  
  96.            information  -  but  may  be  modified by the user with the  
  97.            "FFF" Environment Variable.                                  
  98.  
  99.         -f·Changes the date format  for  the  verbose  form  form  the
  100.            "Military"  form - DD Mon YY - to the "Internationl" form -
  101.            YY-MM-DD - a form that is sortable.
  102.  
  103.         -u·Changes the date format  for  the  verbose  mode  from  the  
  104.            "Military"  form  -  DD  Mon YY - the the more familar "US"
  105.            form - MM/DD/YY.
  106.  
  107.         -p·Reverses the setting of  the  pagination  option.  The  FFF  
  108.            default  is  OFF - do not paginate every 23 lines - but may  
  109.            be  modified  by  the  user  with  the  "FFF"   Environment  
  110.            Variable.  before  continuing.  If the response is anything  
  111.            other  than  'N',  'n'  or  Ctl-C,  the  output  continues,  
  112.            otherwise the program terminates.                            
  113.  
  114.         -q·Suppresses  the  printing of the statistics on total files,  
  115.            files matched, and archive files.                            
  116.  
  117.         -c·Change the output from upper case to lower case.
  118.  
  119. The  case  of  the options is not significant and the option(s) may be 
  120. specified either  before  or  after  the  pattern  specification.  The
  121. options may be specified individually (i.e.  "-a -v -f") or  "stacked" 
  122. (i.e. "-avf") and may be in either upper case or lower case.  The '-f'
  123. and  '-u'  options  or  mutually exclusive and only the last specified
  124. will be in effect, i.e.  if the option '-vfu' were specified, the date
  125. would be shown in "US" format where if the option were to be specified
  126. as '-vuf', the date would be shown in "International" format.
  127.  
  128.  
  129. "FFF" ENVIRONMENT VARIABLE:                                             
  130.                                                                         
  131. With  version  3.1.0,  FFF  will read an optional Environment Variable 
  132. "FFF" to establish its defaults.  The "FFF" Environment  Variable  can 
  133. set  the default disks to be searched and the default setting for each 
  134. of  the  command  line  options.   Any  disks  specified  in  the  FFF
  135. Environment Variable will override the hard-coded default of searching
  136. the  "current  disk".  Options  specified  on  the  command  line will
  137. override those set by the "FFF" Environment Variable.  
  138.                                                                         
  139.  
  140. TERMINATION:
  141.  
  142. Since a number of searches can require a large  amount  of  time,  FFF
  143. provides  the  user  with  the  ability to terminate at any time.  If,
  144. during  the  search,  the  user  presses  the  "ESC"  key,   FFF  will
  145. immediately terminate.
  146.            
  147. EXAMPLES: 
  148.  
  149. On my current hard disk,  the following command will  find  all  files 
  150. whose  name  begins  with  "AC"  on the current disk,  including those 
  151. inside of ARCs,  LZHs,  PAKs,  ZIPs,  and/or ZOOs,  regardless of  the 
  152. extension: 
  153.  
  154.         C:>FFF AC*
  155.  
  156. FFF will respond with the following listing:
  157.  
  158.         FFF: FastFileFind - Version 3.4.5: July 9, 1990                 |
  159.         C:\ACELST.LST
  160.         C:\ACELST
  161.         C:\ACELST.307
  162.         C:\ACELST.ZIP
  163.         C:\ACELST.ZIP--> (ACELST.301)
  164.         C:\ACELST.ZIP--> (ACELST.302)
  165.         C:\ACELST.ZIP--> (ACELST.303)
  166.         C:\ACELST.ZIP--> (ACELST.306)
  167.         C:\ACELST.ZIP--> (ACELST.307)
  168.         C:\ANYWHERE\ACANCEL.EXE
  169.         C:\ANYWHERE\ACHKSUM.EXE
  170.  
  171. The  files,  ACELST.301,  ACELST.302,  ACELST.303,   ACELST.306,   and 
  172. ACELST.307,  shown  in  parentheses  following the file ACELST.ZIP are 
  173. members of that ZIP archive file.  
  174.  
  175. To find all files on the current disk that begin with "AC" and have no  
  176. extension,  including those inside of ARCs,  LZHs,  PAKs, ZIPs, and/or  
  177. ZOOs, would require the following command:                              
  178.  
  179.         C:>FFF AC*.
  180.  
  181. which would produce the following listing:
  182.  
  183.         FFF: FastFileFind - Version 3.4.5 : July 9, 1990                | 
  184.         C:\ACELST
  185.  
  186.  
  187. To search disks A and C for all files that  contain  the  letter  pair 
  188. "WH"  anywhere  if their name,  including those inside of ARCs,  LZHs,  
  189. PAKs, ZIPs, and/or ZOOs, would require the following command:           
  190.  
  191.         C:>FFF AC:*WH*
  192.  
  193. and would produce the following listing:
  194.  
  195.         FFF: FastFileFind - Version 3.4.5: July 9, 1990                 | 
  196.         A:\ANYWHERE.ARC
  197.         A:\ANYWHERE.ARC--> (ANYWHERE.CNF)
  198.         A:\ANYWHERE.ARC--> (ANYWHERE.EXE)
  199.         A:\ANYWHERE.ARC--> (ANYWHERE.MNU)
  200.         A:\ANYWHERE.ARC--> (ANYWHERE.TRM)
  201.         C:\TC\UNIX\WHERE.OBJ
  202.         C:\TC\UNIX\WHERE.EXE
  203.         C:\TC\UNIX\WHERE.C
  204.         C:\DOWNLOAD\WHERE20.ARC
  205.         C:\DOWNLOAD\WHERE20.ARC--> (WHEREIS.DOC)
  206.         C:\DOWNLOAD\WHERE20.ARC--> (WHEREIS.EXE)
  207.         C:\DOWNLOAD\CONFIG20.ARC--> (WHATS.NEW)
  208.         C:\DOWNLOAD\CIS\CTPCOD.ARC--> (ISWHITE.SRC)
  209.         C:\DOWNLOAD\CIS\CTPCOD.ARC--> (SHOWHELP.SRC)
  210.         C:\DOWNLOAD\CIS\CTPCOD.ARC--> (STRIPWHT.SRC)
  211.         C:\UTIL\WH.EXE
  212.         C:\TASM\TASMSTUF.ZIP--> (IWHGLOBL.DEC)
  213.         C:\TASM\TASMSTUF.ZIP--> (WHEREIS.ARC)
  214.         C:\TASM\TASMSTUF.ZIP--> (WHUSAGE.INC)
  215.         C:\ANYWHERE\ANYWHERE.MNU
  216.         C:\ANYWHERE\ANYWHERE.TRM
  217.         C:\ANYWHERE\ANYWHERE.EXE
  218.         C:\ANYWHERE\ANYWHERE.CNF
  219.  
  220. If you wanted to search disk C:, D:, and E:  by default without having  
  221. to specify the "cde:" on the command line each time, you could set the  
  222. "FFF" Environment Variable:                                             
  223.                                                                         
  224.     SET FFF=CDE                                                         
  225.                                                                         
  226. in your AUTOEXEC.BAT.  The, if you issue the command:                   
  227.                                                                         
  228.     C:>FFF FFF*                                                         
  229.                                                                         
  230. FFF will search drives C:,  D:,  and E:  for all files beginning  with  
  231. "FFF"  regardless  of  the extension,  including those inside of ARCs,  
  232. LZHs,  PAKs,  ZIPs and/or ZOOs.  If you had set the "FFF"  Environment  
  233. Variable  as  shown  above and wanted to search only on drive C:,  for  
  234. example, you would have to enter the command:                           
  235.                                                                         
  236.     C:>FFF C:FFF*                                                       
  237.                                                                         
  238. The specification of  C:  on  the  command  line  would  override  the  
  239. defaults established by the "FFF" Environment Variable.                 
  240.                                                                         
  241. The "FFF" Environment Variable can also be used to  set  the  defaults  
  242. for the '-a',  '-v',  '-f-,  '-p',  and 'q' command line options.  For  
  243. example:                                                                
  244.                                                                         
  245.     SET FFF=CDE -a                                                      
  246.                                                                         
  247. would set the default to NOT search inside of archive files.  Again, a  
  248. command line option would override the "FFF" Environment Variable.  If  
  249. you had set the  "FFF"  Environment  Variable  to  suppress  searching  
  250. inside of archives,  you could have FFF search inside of archive files  
  251. anyway with the command line:                                           
  252.                                                                         
  253.     C:>FFF FFF* -a                                                      
  254.  
  255.  
  256.          ----------------end-of-author's-documentation---------------
  257.  
  258.                         Software Library Information:
  259.  
  260.                    This disk copy provided as a service of
  261.  
  262.                         The Public (Software) Library
  263.  
  264.          We are not the authors of this program, nor are we associated
  265.          with the author in any way other than as a distributor of the
  266.          program in accordance with the author's terms of distribution.
  267.  
  268.          Please direct shareware payments and specific questions about
  269.          this program to the author of the program, whose name appears
  270.          elsewhere in  this documentation. If you have trouble getting
  271.          in touch with the author,  we will do whatever we can to help
  272.          you with your questions. All programs have been tested and do
  273.          run.  To report problems,  please use the form that is in the
  274.          file PROBLEM.DOC on many of our disks or in other written for-
  275.          mat with screen printouts, if possible.  The P(s)L cannot de-
  276.          bug programs over the telephone.
  277.  
  278.          Disks in the P(s)L are updated monthly, so if you did not get
  279.          this disk  directly from the P(s)L,  you should be aware that
  280.          the files in this set may no  longer be the current versions.
  281.  
  282.          For a copy of the latest monthly software library newsletter
  283.          and a list of the 2,000+ disks in the library, call or write
  284.  
  285.                         The Public (Software) Library
  286.                               P.O.Box 35705
  287.                            Houston, TX 77235-5705
  288.                                (713) 524-6394
  289.  
  290.